home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmSetProtocolHooks.z / XmSetProtocolHooks
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss - A VendorShell function that allows
  10.           preactions and postactions to be executed when a protocol
  11.           message is received from MWM
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           #include <Xm/Xm.h>
  15.           #include <Xm/Protocols.h>
  16.           vvvvooooiiiidddd XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss(
  17.           WWWWiiiiddddggggeeeetttt sssshhhheeeellllllll,
  18.           AAAAttttoooommmm pppprrrrooooppppeeeerrrrttttyyyy,
  19.           AAAAttttoooommmm pppprrrroooottttooooccccoooollll,
  20.           XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc pppprrrreeeehhhhooooooookkkk,
  21.           XXXXttttPPPPooooiiiinnnntttteeeerrrr pppprrrreeee____cccclllloooossssuuuurrrreeee,
  22.           XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc ppppoooosssstttthhhhooooooookkkk,
  23.           XXXXttttPPPPooooiiiinnnntttteeeerrrr ppppoooosssstttt____cccclllloooossssuuuurrrreeee);
  24.  
  25.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  26.           This page documents Motif 2.1.
  27.  
  28.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.           XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss is used by shells that want to have
  30.           preactions and postactions executed when a protocol message
  31.           is received from MWM.  Since there is no guaranteed ordering
  32.           in execution of event handlers or callback lists, this
  33.           allows the shell to control the flow while leaving the
  34.           protocol manager structures opaque.
  35.  
  36.           XXXXmmmmSSSSeeeettttWWWWMMMMPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss is a convenience interface.  It calls
  37.           XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkksssswith the property value set to the atom
  38.           returned by interning WWWWMMMM____PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLLSSSS.
  39.  
  40.           _s_h_e_l_l     Specifies the widget with which the protocol
  41.                     property is associated
  42.  
  43.           _p_r_o_p_e_r_t_y  Specifies the protocol property
  44.  
  45.           _p_r_o_t_o_c_o_l  Specifies the protocol atom
  46.  
  47.           _p_r_e_h_o_o_k   Specifies the procedure to call before calling
  48.                     entries on the client callback list
  49.  
  50.           _p_r_e__c_l_o_s_u_r_e
  51.                     Specifies the client data to be passed to the
  52.                     prehook when it is invoked
  53.  
  54.           _p_o_s_t_h_o_o_k  Specifies the procedure to call after calling
  55.                     entries on the client callback list
  56.  
  57.           _p_o_s_t__c_l_o_s_u_r_e
  58.                     Specifies the client data to be passed to the
  59.                     posthook when it is invoked
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    XXXXmmmmSSSSeeeettttPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           For a complete definition of VendorShell and its associated
  75.           resources, see VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll(3).
  76.  
  77.      RRRREEEELLLLAAAATTTTEEEEDDDD
  78.           VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll(3), XXXXmmmmIIIInnnntttteeeerrrrnnnnAAAAttttoooommmm(3), and
  79.           XXXXmmmmSSSSeeeettttWWWWMMMMPPPPrrrroooottttooooccccoooollllHHHHooooooookkkkssss(3).
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.